home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 126-150 / scopedisk146 / format / formatter2.0.dox < prev    next >
Text File  |  1995-03-19  |  7KB  |  147 lines
  1. =========================== Formatter 2.0 ============================
  2. ======================================================================
  3. A  floppy  disk formatting program, written by Olaf 'Olsen' Barthel of
  4. MXM.   Copyright,  © 1990 by MXM.  Public domain, all rights reserved.
  5. No guarantee of any kind is made that the program(s) described in this
  6. document are 100% reliable.  You use this material on your own risk.
  7.  
  8. ============================== Purpose ===============================
  9. ======================================================================
  10. The  standard  'format'  command surely does a brilliant job, since it
  11. gets  around  with  any device driver and partitions of any size.  But
  12. which  data media is formatted most oftenly?  Floppy disks (3½" format
  13. hardwired  to  the  Amiga  computer)  of  course.  'Formatter 2.0' was
  14. written  to fit the niche for fast(er) and user friendlier floppy disk
  15. formatting  programs.   It  also  shows  how to format file systems in
  16. general and how to get AmigaDOS to accept them.
  17.  
  18. =============================== Usage ================================
  19. ======================================================================
  20. 'Formatter  2.0'  can  be  called both from Shell and Workbench.  Note
  21. that arp.library is required to run the program (Yuck!).
  22.  
  23.          The following command line parameters are supported:
  24.  
  25. DRIVE/A........    This can be any disk drive from DF0:  through DF3:  as
  26.         long  as it's really connected.  You will get an error
  27.         message  if  the  disk  drive  cannot  be found in the
  28.         current DOS mountlist.
  29.  
  30. NAME/K.........    The  name you wish the formatted disk to receive.  Any
  31.         name longer than 31 characters will be truncated.
  32.  
  33. FAST/S.........    No  secret  fast formatting tricks yet, this option is
  34.         similar to the 'QUICK' switch of the standard 'format'
  35.         command:   if enabled only the root block and the boot
  36.         block  of  the  disk  will  be rewritten (clearing all
  37.         relevant  data).   If  your  disks  have  already been
  38.         formatted clearing those blocks can save much time.
  39.  
  40. INSTALL/S......    If  you  want  to use the formatted disk as a bootable
  41.         AmigaDOS disk, 'Formatter 2.0' will install it just as
  42.         if you had used the AmigaDOS 'Install' command on it.
  43.  
  44. VERIFY/S.......    If   enabled,  each  write  access  to  disk  will  be
  45.         verified,  i.e.  the disk blocks being written will be
  46.         reread and compared with the source data.  Needless to
  47.         say,  verification  slows  down  the  disk  formatting
  48.         process  but  helps  to  tell  the good disks from the
  49.         corrupt ones.
  50.  
  51. AUTOSTART/S....    If enabled, any disk inserted into the specified drive
  52.         will be formatted automatically.  This saves some time
  53.         if  lots  of  disks have to be formatted one after the
  54.         other.
  55.  
  56. A  small  window  will pop up on the Workbench screen (right under the
  57. mouse  pointer  if  possible).   The window will look like this (well,
  58. roughly, I never claimed being a graphic artist, did I?):
  59.  
  60.       #X#Formatter2.0======================##|##
  61.       |..   ..   ..   ..   ..   ..   ..   ..   | <- Track numbers
  62.       ||    |    |    |    |    |    |    |    |
  63.       |----------------------------------------|
  64.       |                                        | <- Process indicator
  65.       |------------+--+-------------+----------|
  66.       | Auto start |  | Fast format |          | <- Some gadgets
  67.       |------------+  +-------------+   Start  |
  68.       |Verify write|  |Install disk |          | <- Some more gadgets
  69.       |--------+-+-+------+-+-------++ +-------|
  70.       |  DF0:  | |  DF1:  | |  DF2:  | |  DF3: | <- Drive selection
  71.       |--------+ +--------+ +--------+ +-------|
  72.       |         +------------------------------|
  73.       | Name:   | Blank                        | <- Name string gadget
  74.       |         +------------------------------|
  75.       +----------------------------------------+
  76.  
  77. Control  should  be  intuitively  (why  shouldn't  it,  you're running
  78. Intuition  anyway, aren't you?), if you've understood the command line
  79. options  (to  which  the gadgets somehow correspond to) you should get
  80. along with the rest of the program easily.
  81.  
  82. ========================= Keyboard shortcuts =========================
  83. ======================================================================
  84. To  make  life  easier,  each  gadget  in  the  control  window can be
  85. enabled/toggled via keyboard.  The keys are:
  86.  
  87.     A .............    Toggle 'Auto start'.
  88.     F .............    Toggle 'Fast format'.
  89.     V ............. Toggle 'Verify write'.
  90.     I .............    Toggle 'Install disk.'
  91.     1-4 ...........    Select a disk drive.
  92.     Return key.....    Start/Stop formatting.
  93.     Escape key.....    Close the window, leave the program.
  94.  
  95. ====================== Formatter 2.0 vs. format ======================
  96. ======================================================================
  97. 'Formatter  2.0'  is  limited to the 3½" drives hardwired to the Amiga
  98. computer,  no  other filesystems will be formatted.  The disks will be
  99. formatted  using  the old standard file system, FastFileSystem support
  100. would  be easy to add (simply change the ID_DOS_DISK into ID_FFS_DISK,
  101. that's how 'format' does the trick) but isn't included yet.
  102.     Formatting  time  is  well  below  the  time  'format'  needs;
  103. formatting  a  disk without verify takes between 52 and 54 seconds, if
  104. verify  is  enabled formatting will take between 1:42 minutes and 1:44
  105. minutes.   The  step  delay of the drive motors is not touched, nobody
  106. knows  how  the  different  drives  by  various manufacturers react on
  107. different rates.
  108.  
  109. ============================== Credits ===============================
  110. ======================================================================
  111. Credits  go  to  Mark Rinfret for the very, very basic disk formatting
  112. routines  employed  by his harddisk backup program.  It took some time
  113. to  spy out the default disk format information.  The block types were
  114. picked  up  both  from  Ralph Babel's 'Amiga Guru' book and the Bantam
  115. AmigaDOS Programmers' manual.
  116.  
  117. =============================== Author ===============================
  118. ======================================================================
  119. This  program was written by Olaf Barthel of MXM.  All files have been
  120. placed in the public domain.  You may freely distribute this material,
  121. even  a  small  copy  fee  is  okay  but  everything  which looks like
  122. commercial distribution is forbidden.  Still you may use this material
  123. for software development without giving credit to the original author.
  124.  
  125. Send   new   program  revisions,  comments,  bug  reports,  donations,
  126. unmarried   sisters,   non-poisoned   candy,  home-grown  palm  trees,
  127. horoscopes, promising capital investments, etc.  to:
  128.  
  129.                           Olaf Barthel, MXM
  130.                           Brabeckstrasse 35
  131.                           D-3000 Hannover 71
  132.  
  133.                      Federal Republic of Germany
  134.  
  135. ============ Revision history (most recent change first) =============
  136. ======================================================================
  137. V2.0    A complete rewrite  of  the  original  program,  first  public
  138.     release.
  139.  
  140. V1.0    A very limited disk formatting program.
  141.  
  142.                                   *
  143.  
  144.              Do only its possibilities make it an Amiga?
  145.  
  146.                         WHERE IS THE MAGIC ???
  147.